/* @flow */

import config from '../config'
import { initProxy } from './proxy'
import { initState } from './state'
import { initRender } from './render'
import { initEvents } from './events'
import { mark, measure } from '../util/perf'
import { initLifecycle, callHook } from './lifecycle'
import { initProvide, initInjections } from './inject'
import { extend, mergeOptions, formatComponentName } from '../util/index'

let uid = 0

// 实现_init初始化方法  都做了什么
export function initMixin(Vue: Class<Component>) {
  
  // 根据组件的数量来初始化  example: 根组件  子组件，这里会进来两次
  Vue.prototype._init = function (options?: Object) {
    const vm: Component = this
    // a uid
    vm._uid = uid++

    let startTag, endTag
    /* istanbul ignore if */
    if (process.env.NODE_ENV !== 'production' && config.performance && mark) {
      startTag = `vue-perf-start:${vm._uid}`
      endTag = `vue-perf-end:${vm._uid}`
      mark(startTag)
    }

    // a flag to avoid this being observed
    vm._isVue = true
    // 合并选项  用户传递 当前构造函数的   其父级构造函数的 选项
    if (options && options._isComponent) {
      // 优化内部组件实例化 因为动态选项合并非常缓慢  内部组件选项需要特殊处理。
      
      initInternalComponent(vm, options)
    } else {
      // 在合并当前实例的构造函数的选项，用户传递的  vm自身  最后挂载到$options
      // 这里的合并有用到策略模式
      vm.$options = mergeOptions(
        resolveConstructorOptions(vm.constructor),  // 返回的是一个 vm.constructor.options，相当于 Vue.options  代码在initGlobalAPI 
        options || {},
        vm
      )
    }
    /* istanbul ignore else */
    if (process.env.NODE_ENV !== 'production') {
      initProxy(vm)
    } else {
      vm._renderProxy = vm
    }
    // 通过调用一些初始化函数来为Vue实例初始化一些属性，事件，响应式数据等
    vm._self = vm
    initLifecycle(vm) // 初始化生命周期  找到并定义组件的$parent 和$root
    initEvents(vm)// 初始化事件  初始化的是父组件在模板中使用v-on或@注册的监听子组件内触发的事件

    initRender(vm)// 初始化渲染
    // 上面3种像是在为下面的执行做了些初始化，定义了需要用到的方法和变量等，将他们放在了vm上，也区分了内部使用和外部使用的变量
    callHook(vm, 'beforeCreate') // 调用生命周期钩子函数
    // 这里所说的数据就是我们通常所写data、props、watch、computed及method，所以inject选项接收到注入的值有可能被以上这些数据所使用到，
    // 所以在初始化完inject后需要先初始化这些数据，然后才能再初始化provide，
    // 所以在调用initInjections函数对inject初始化完之后需要先调用initState函数对数据进行初始化，最后再调用initProvide函数对provide进行初始化。
    initInjections(vm) // 初始化injections   ---对注入的数据做响应式处理
    initState(vm)// 初始化props,methods,data,computed,watch 按顺序执行  这里面对data做响应式处理，做代理
    initProvide(vm) //  初始化 provide
    callHook(vm, 'created')// 调用生命周期钩子函数

    /* istanbul ignore if */
    if (process.env.NODE_ENV !== 'production' && config.performance && mark) {
      vm._name = formatComponentName(vm, false)
      mark(endTag)
      measure(`vue ${vm._name} init`, startTag, endTag)
    }
    // 如果传入了则调用$mount函数进入模板编译与挂载阶段， 执行完挂载；页面第一次更新
    // 这里如果没传入el，则需要用户手动执行vm.$mount才能进入下一个生命周期阶段
    if (vm.$options.el) {
      vm.$mount(vm.$options.el)
    }
  }
}

export function initInternalComponent(vm: Component, options: InternalComponentOptions) {
  const opts = vm.$options = Object.create(vm.constructor.options)
  // doing this because it's faster than dynamic enumeration.
  const parentVnode = options._parentVnode
  opts.parent = options.parent
  opts._parentVnode = parentVnode

  const vnodeComponentOptions = parentVnode.componentOptions
  opts.propsData = vnodeComponentOptions.propsData
  opts._parentListeners = vnodeComponentOptions.listeners
  opts._renderChildren = vnodeComponentOptions.children
  opts._componentTag = vnodeComponentOptions.tag

  if (options.render) {
    opts.render = options.render
    opts.staticRenderFns = options.staticRenderFns
  }
}

export function resolveConstructorOptions(Ctor: Class<Component>) {
  let options = Ctor.options
  // 构造函数的父级
  if (Ctor.super) {
    const superOptions = resolveConstructorOptions(Ctor.super)
    const cachedSuperOptions = Ctor.superOptions
    if (superOptions !== cachedSuperOptions) {
      // super option changed,
      // need to resolve new options.
      Ctor.superOptions = superOptions
      // check if there are any late-modified/attached options (#4976)
      const modifiedOptions = resolveModifiedOptions(Ctor)
      // update base extend options
      if (modifiedOptions) {
        extend(Ctor.extendOptions, modifiedOptions)
      }
      options = Ctor.options = mergeOptions(superOptions, Ctor.extendOptions)
      if (options.name) {
        options.components[options.name] = Ctor
      }
    }
  }
  return options
}

function resolveModifiedOptions(Ctor: Class<Component>): ?Object {
  let modified
  const latest = Ctor.options
  const sealed = Ctor.sealedOptions
  for (const key in latest) {
    if (latest[key] !== sealed[key]) {
      if (!modified) modified = {}
      modified[key] = latest[key]
    }
  }
  return modified
}
